home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2009 February / PCWFEB09.iso / Software / Linux / Kubuntu 8.10 / kubuntu-8.10-desktop-i386.iso / casper / filesystem.squashfs / usr / share / doc / libqt3-mt / README.immodule < prev    next >
Encoding:
Text File  |  2008-05-02  |  3.1 KB  |  108 lines
  1. immodule for Qt
  2.  
  3.  
  4. * What is this?
  5.  
  6.   immodule for Qt is a modular, extensible input method subsystem for
  7.   Qt.
  8.  
  9.   This project brings functionality similar to the immodule for GTK+
  10.   to the Qt library. The main goal of the project is to extend and
  11.   enhance the input method support in the Qt library, in order to
  12.   provide a modern and powerful multi-language input system. Our short
  13.   term goal is to make Qt (especially Qt/X11) "up-to-date" with other
  14.   X11-based toolkits such as GTK+. We are also focusing on what the
  15.   input method API should be for future Qt versions.
  16.  
  17.   See our webpage for further information.
  18.  
  19.   http://immodule-qt.freedesktop.org/
  20.  
  21.  
  22. * About this release
  23.  
  24.   qt-x11-immodule-unified-qt3.3.3-20040910 is a stable release. Since
  25.   it breaks backward compatibility (source and binary) about immodule
  26.   with our previous releases qt-x11-immodule-unified-qt3.3.3-20040819
  27.   and qt-x11-immodule-bc-qt3.3.2-20040623, optional immodule plugins
  28.   must be updated to proper version. See 'Optional immodule plugins'
  29.   section of our download page.
  30.  
  31.   http://immodule-qt.freedesktop.org/Software/ImmoduleQtDownload
  32.  
  33.   However, backward compatibility (source and binary) with normal Qt
  34.   3.3.3 is kept in 'Binary Compatible' mode.
  35.  
  36.  
  37. * How to install
  38.  
  39.   After extract the Qt archive, perform following instructions
  40.  
  41.     cd qt-x11-free-3.3.3
  42.     patch -p0 < qt-x11-immodule-unified-qt3.3.3-20040910.diff
  43.     ./make-symlinks.sh
  44.     ./configure
  45.  
  46.   Our patch provides following two configure options. Choose 'Binary
  47.   Compatible' for normal use.
  48.  
  49.   Build Qt with 'Binary Compatible' immodule support (default)
  50.  
  51.     configure -inputmethod
  52.  
  53.   Build Qt without binary compatibility, but supports more advanced
  54.   immodule extensions. It cannot be used with ordinary application
  55.   binaries (i.e. the option is for developers)
  56.  
  57.     configure -inputmethod -inputmethod-ext
  58.  
  59.  
  60. * How to use
  61.  
  62.   - See users manual of each input method plugins
  63.  
  64.   - Run qtconfig to choose your favorite XIM input style
  65.  
  66.  
  67. * Environment variables
  68.  
  69.   Some environment variables are available for expert users and system
  70.   integrators. The specification is preliminary and may be changed
  71.   without notification. Be careful.
  72.  
  73.   See following examples to use the variables.
  74.  
  75.  
  76.   - set "xim" input method as default
  77.  
  78.     export QT_IM_MODULE=xim
  79.  
  80.  
  81.   - set "simple" composing input method as default
  82.  
  83.     export QT_IM_MODULE=simple
  84.  
  85.  
  86.   - set "xim" input method as default, and disable input method
  87.     selection menu in the context menu
  88.  
  89.     export QT_IM_SWITCHER=imsw-none
  90.     export QT_IM_MODULE=xim
  91.  
  92.  
  93.   - set "xim" input method as default, and enable input method
  94.     selection menu in the context menu (default configuration)
  95.  
  96.     export QT_IM_SWITCHER=imsw-multi
  97.     export QT_IM_MODULE=xim
  98.  
  99.  
  100.   - set "iiimqcf" that has its own input method switching framework as
  101.     default, and disable input method selection menu in the context
  102.     menu. Such configuration is required by some system integrators to
  103.     provide unified user interface for global input method switching
  104.     over the desktop
  105.  
  106.     export QT_IM_SWITCHER=imsw-none
  107.     export QT_IM_MODULE=iiimqcf
  108.